---
title: "01-Maven 安装与配置"
created: 2025-11-28
tags:
  - 项目筑基
---
# Maven 安装与配置

> **Maven** 是一个 **Java 项目管理与构建自动化工具**，它通过提供统一的构建流程和项目管理规范，使得 Java 项目的构建、依赖管理、文档生成等工作变得更加高效和简单。Maven 通过 **POM（Project Object Model）** 文件来管理项目的配置，依赖、插件和构建等内容。

## Maven环境配置

IDEA 内置了 Maven，但命令行执行需要配置环境变量。

1. **找到 IDEA 的 Maven 安装位置**
   - 找 IDEA 安装目录下的 `plugins\maven\lib\maven3`
     ![[2-Learning/03-项目筑基/04-工具与环境/04-构建与版本控制/assets/image-ebaba0ac.png]]
   - 或者 打开 IDEA → File → Settings → Build, Execution, Deployment → Maven 查看 Maven home path，比如 `C:\Users\你的用户名\.m2\...`
2. **配置环境变量**
   - 右键"此电脑"→ 属性 → 高级系统设置 → 环境变量
   - 新建系统变量 `MAVEN_HOME`，值为上面找到的 Maven 路径

     ![[2-Learning/03-项目筑基/04-工具与环境/04-构建与版本控制/assets/image-430ac5fa.png]]
   - 编辑 `Path`，添加 `%MAVEN_HOME%\bin`

     ![[2-Learning/03-项目筑基/04-工具与环境/04-构建与版本控制/assets/image-414f5e29.png]]
   - 重启命令行，执行 `mvn -v` 验证

     ![[2-Learning/03-项目筑基/04-工具与环境/04-构建与版本控制/assets/image-66b3f667.png]]

## **Maven 常见命令**

| 命令 | 说明 |
| --- | --- |
| `mvn clean` | 清除目标文件夹（`target/`） |
| `mvn compile` | 编译源代码 |
| `mvn test` | 运行项目的测试 |
| `mvn package` | 打包项目，生成 JAR 文件 |
| `mvn install` | 安装依赖并将项目打包到本地 Maven 仓库 |
| `mvn deploy` | 将项目发布到远程 Maven 仓库 |
| `mvn exec:java` | 执行 Maven 项目（需要配置 Maven 插件） |
| `mvn dependency:tree` | 查看项目的依赖树 |

## 配置镜像（可选）

可在setting文件中添加镜像`D:\develop\java\IntelliJ IDEA 2024.1\plugins\maven\lib\maven3\conf\settings.xml`

![[2-Learning/03-项目筑基/04-工具与环境/04-构建与版本控制/assets/image-eb6d4074.png]]

```
<mirrors>
	 <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>
```

## 本地仓库位置（建议改到 D 盘）

默认在 `C:\Users\你的用户名\.m2\repository`，C 盘越用越满。`settings.xml` 里加一行改走 D 盘：

```
<localRepository>D:\develop\maven-repo</localRepository>
```

IDEA 里也要对上：Settings → Build Tools → Maven → 勾 **Override** 选同一个 settings.xml，否则 IDEA 和命令行各用一套仓库。

## 常见坑

- **依赖下载一半断网** → 本地仓库里会留下 `xxx.lastUpdated` 残文件，之后怎么刷都不重新下载。清掉同名 `.lastUpdated` 文件（或直接删整个版本目录）再 reimport 即可。
- **pom 改了 IDEA 不认** → Maven 面板点 🔄（Reload All Maven Projects）。
- `mvn -v` 显示的 Java 版本不对 → Maven 跟着 `JAVA_HOME` 走，不是跟 IDEA 里配的 SDK 走。

---
⬅️ [[02-RabbitMQ 安装与配置|RabbitMQ 安装与配置]] 🏠 [[00-工具与环境|00-工具与环境]] ➡️ [[02-git 安装与配置|git 安装与配置]]